「AWS CDK intro Workshop」の紹介

t.honda

2022.01.20

この記事は公開されてから1年以上経過しています。情報が古い可能性がありますので、ご注意ください。

はじめに

AWS CDK v2が出てから触っていなかったことと、(v1を含め)AWS CDKをしばらく使っていなかったので、復習のためにチュートリアル的なものを探していたところ、公式のワークショップがありました。

AWS CDK intro Workshop

このワークショップをやってみたのですが、(IDEなどの)入力補完の威力を実感しつつ、コマンドを一つずつ実行してAWSにリソースを作っていく過程を体験できる構成となっており、AWS CDKを使ったことがない・もしくは使用経験が浅い方などに是非やってみて欲しいと感じました。

以下、このワークショップの目次や概要などについて紹介したいと思います。以下をご覧いただき、興味を持たれた場合は一度ワークショップをやってみることをお勧め致します。

なお、今回TypeScriptでワークショップを行いました。なのでTypeScript以外の部分については割愛させて頂きます。

ワークショップの目次

まずワークショップの目次についてです。事前準備とTypeScriptでのワークショップに限定して目次を抜粋してみました。

Prerequisites
TypeScript Workshop
- New Project
  - cdk init
  - npm run watch
  - Project structure
  - cdk synth
  - cdk deploy
- Hello, CDK!
  - Cleanup sample
  - Hello Lambda
  - CDK Watch
  - API Gateway
- Writing constructs
  - Define the HitCounter API
  - Hit counter handler
  - Define resources
  - Use the hit counter
  - CloudWatch Logs
  - Granting permissions
  - Test the hit counter
- Using construct libraries
  - Learning about the Table Viewer construct
  - Installing the library
  - Add the table viewer to your app
  - Exposing our hit counter table
  - Deploying our app
  - Extra credit
- Clean up
- Advanced Topics
  - Testing Constructs
    - Assertion Tests
    - Validation Tests
  - CDK Pipelines
    - Getting Started with Pipelines
    - Create Repository
    - Create New Pipeline
    - Add Application to Pipeline
    - Polish Pipeline
    - Cleanup

上から眺めてみると、事前準備(Prerequisites)から始まり、プロジェクトの作成、Hello Worldにあたる「Hello, CDK!」、リソース構成を定義する「Writing constructs」・・・、最後に作成したリソースを消去する「Clean up」、という流れで進めることができるようになっています。「Clean up」までで一通りのリソース作成〜削除まで網羅されており、「Advanced Topics」にてテストの記述、デプロイパイプラインの構築について取り上げられています。

次に自分がやってみたところの概要です。

事前準備(Prerequisites)の概要

「Prerequisites」のページには必要なものが記載されています。それを踏まえつつ、私が準備 & インストールしたものを以下に挙げます。

AWS CLI
AWS Account and User
Node.js
IDE
AWS CDK Toolkit
(著者追加)curl

AWS CLI・Node.jsについては、私の場合はdocker-composeを用意して、これらがインストール済みのコンテナを使いました。コンテナを作るためのdocker-compose.yml・Dockerfileについては以下の記事を参照ください。 docker-composeとlocalstackを使ってローカルでAWS SDK for JavaScript V3を動かしてみる

IDEについては、入力補完を使いつつ、コピー&ペーストせずに手入力することを進める箇所があることもあり、何らかのIDEや補完機能があるエディタを使うことを私も推奨します。中でもVisual Studio Codeが「recommended」となっており、私もVisual Studio Codeを使用しました。他には AWS Cloud9、WebStorm、Eclipseなどが挙げられています。

curlについては「Prerequisites」には挙げられていませんが、進めるにつれてcurlでAPI GatewayのURLを叩くことがあります。Windowsマシンなどでインストールされていない場合は準備しておくことをお勧めします。

他、TypeScript以外で実装するなら